home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / rexx / wbrexx_1_1.lzh / README < prev    next >
Text File  |  1988-06-24  |  4KB  |  71 lines
  1.                               WBRexx
  2.                               ======
  3.  
  4.                      Copyright 1988, W.G.J. Langeveld
  5.                            All Rights Reserved
  6.                           Freely  Distributable
  7.  
  8.  
  9.     WBRexx is a program that allows you to run your REXX scripts from the
  10. workbench. This file contains the executable, the sources and some example
  11. icons and scripts. The file marquis.rexx is courtesy Bill Hawes.
  12.     This is an update to a previously released version. One level of quotes
  13. has been eliminated in the ToolType strings, see later.
  14.  
  15.     First copy the program WBRexx to a place of your choosing. This archive
  16. assumes you will copy it to a directory with the logical name tools: . Of course
  17. you may copy it anyplace you like, but then you must change the  default tool in
  18. all icons (they have been set to tools:WBRexx).
  19.     Then, execute "executeme" to rename several files.
  20.     You run an ARexx script from the Workbench simply by giving it an icon
  21. such as the ones in this archive (like marquis.rexx.info). After making sure the
  22. default tool points to the right place (using the "Info" option of the Workbench
  23. menu), you double-click on the icon and the script is submitted to REXX. Since
  24. the Workbench has no input/output handling, and since this program does not open
  25. input/output windows, not all scripts are suitable for this purpose: any
  26. standard input or output (like ARexx "say") will go to the bitbucket. If you
  27. want this type of thing, you must open console windows yourself, like in
  28. marquis.rexx.
  29.     You can also click on the icon, hold down the shift key on the keyboard
  30. and double-click on the WBRexx tool icon. In fact you can execute several 
  31. scripts in a row by extended-selecting them all and double-clicking on WBRexx.
  32.     You can also use a shortcut: If you have a script which is really small
  33. you may want to put it in as a string command. To do this, use "Info" from the
  34. Workbench menu to edit the icon, and add the tool type:
  35.  
  36.     RX=your-favorite-in-line-rexx-macro-goes-here
  37.  
  38. For example, to run TxEd, the tooltype would be:
  39.  
  40.     RX=address command 'c:e'
  41.  
  42.     In order for this to work, the icon file must NOT have an associated
  43. regular file, i.e. if your icon is runtxed.rexx.info, there must NOT be a file
  44. called runtxed.rexx. Only if the .info file is all by itself, will WBRexx check
  45. for a tooltype. In all other cases it will assume that you really want to submit
  46. the associated file to REXX. Also, WBRexx checks only for ONE RX tooltype, and
  47. it only uses the first one it can find. (Notice, that in a previous version, the
  48. entire string had to be enclosed in quotes. This is no longer necessary, and in
  49. fact will not work anymore - this is because I fixed what was in fact a bug).
  50.     There is a catch 22 situation here. Under 1.2, it is not possible to
  51. edit an icon using "Info" if the icon does not belong to a file. The Info
  52. program will briefly flash up, and exit again. This has been changed in 1.3:
  53. there you can edit icons that stand by themselves. For now, to use this feature
  54. under 1.2 you should have a dummy file associated with your icon before you edit
  55. it. Then you can edit the icon, and then you must delete the dummy file.
  56.     Finally, you will sometimes wonder why nothing is happening. It may be
  57. helpfull to see what actually was done by WBRexx. Therefore, WBRexx itself has
  58. a tooltype it checks. This is the tooltype DEBUG. It can be either ON or OFF.
  59. For example, if you want debugging, the WBRexx icon should contain the tooltype:
  60.  
  61.     DEBUG=ON
  62.  
  63. This causes WBRexx to display in three steps how it arrives at the string it
  64. will send to REXX. This option only works by using extended select (because only
  65. then will the WBRexx icon be used).
  66.     If there are any questions, I'm sure I'll hear about them on BIX in 
  67. amiga.user/arexx.
  68.  
  69.     Willy.
  70.  
  71.